ποΈGitΠ―ΡΠ°ποΈ
docs/README.md 988db081b289cbc23d9bceef8e7d85ab46d0e6a4 (988db081) Text, 2.32 KB
Documentation Structure
This directory contains the source documentation for the Meshtastic Android/Desktop/iOS app.
It serves three consumers:
1. In-app docs browser β bundled via Compose Resources at build time
2. Jekyll site β GitHub Pages (this directory is the Jekyll source root)
3. meshtastic.org β Docusaurus sync (upstream consumption)
Locale Layout
T282828
docs/
βββ _config.yml, _data/, _layouts/, _sass/ β Jekyll site infrastructure
βββ en/ β English source (edit here)
β βββ user/ β User Guide pages
β βββ developer/ β Developer Guide pages
β βββ index.md β Site home page
β βββ user.md β User Guide nav parent
β βββ developer.md β Developer Guide nav parent
βββ fr-rFR/ β French (Crowdin-generated)
β βββ user/ β Translated user guide
βββ de-rDE/ β German (Crowdin-generated)
β βββ user/
βββ ... β Other locales
Editing Guidelines
β’ English source: Edit files under T383838docs/en/. These are the authoritative source.
β’ Translations: Do not edit files in locale folders directly. They are auto-generated
by Crowdin and will be overwritten on sync.
Contribute translations via Crowdin instead.
β’ Adding a page: Create the T383838.md file in T383838docs/en/user/ or T383838docs/en/developer/, then
register it in T383838feature/docs/.../DocBundleLoader.kt for in-app bundling.
How Translations Work
1. English source files (T383838docs/en/user/*.md) are uploaded to Crowdin as translation sources
2. Volunteers translate via the Crowdin web UI
3. Crowdin PRs land translated files at T383838docs/{android_code}/user/*.md (e.g., T383838fr-rFR, T383838pt-rBR)
4. At build time, the Gradle T383838syncTranslatedDocsToComposeResources task bundles them into
locale-qualified Compose Resources for the in-app reader
5. The in-app T383838DocBundleLoader tries the user's locale first, then falls back to English
Served by rngit 1.5.0 - Generated in 0.04s